Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Dialog Box Messages

GXFilterPanelEvent

QuickDraw GX sends the GXFilterPanelEvent message when an event happens in a panel. You can override the GXFilterPanelEvent message to add panels that need a filter procedure. Your override of the GXFilterPanelEvent message must match the following formal declaration:

OSErr MyFilterPanelEvent (gxPanelInfoRecord *aPanelInfoRecord; 
                        Boolean *returnImmed);

aPanelInfoRecord

A pointer to the panel information structure that supplies information to the panel about the current dialog box and panel event.

returnImmed

On return, a Boolean value that is true if there should be no further processing on this event and false if not.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXFilterPanelEvent message to filter panel events in a dialog box.

The default implementation of this message does nothing. You need to override this message if you add panels that require a filtering process.

SPECIAL CONSIDERATIONS

You never send the GXFilterPanelEvent message yourself.

You always perform a total override of the GXFilterPanelEvent message, in which you filter any events that occur in your panel.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The panel information structure is described on page 4-35.

Print dialog boxes and panels are described in Inside Macintosh: QuickDraw GX Printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help